home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / info-service / gopher / VieGOPHER / viegophr.readme < prev    next >
Encoding:
Text File  |  1993-06-16  |  8.1 KB  |  199 lines
  1.  
  2. FILE viegophr.readme (.rme)
  3.  
  4. written:       1992-10-30 <Gerhard.Gonter@wu-wien.ac.at>
  5. latest update: 1993-06-16
  6.  
  7.  
  8. =========================================================================
  9. INTRODUCTION:
  10.  
  11. This file gives a short overview about the items from the VieGOPHER
  12. package along with quick'n'dirty installation instructions.
  13.  
  14. I finally decided to ship the package at this stage, knowing that some
  15. clean-up work needs to be done, mostly in the documentation.  The basis
  16. for my decision was that the current version is fairly stable.
  17.  
  18. The files are available from
  19.   olymp.wu-wien.ac.at   /pub/src/VieGOPHER
  20.   boombox.micro.umn.edu /pub/gopher/VieGOPHER                (not yet ??)
  21.   awiwuw11.wu-wien.ac.at /gopher.191
  22.                         (userid=anonymou, passwd=guest)
  23.  
  24. =========================================================================
  25. THE PACKAGE:
  26.  
  27. The standard package contains the following files:
  28. viegophr.readme         this file
  29. viegophr.product        PRODUCT file with all REXX modules
  30. viegophr.ps             documentation in Postscript format
  31. vieg-um.ps              user documentation in Postscript format
  32. rose.exec               the installation engine
  33. rose.doc                instructions for the installation engine
  34. viegophr.question       a few questions about VieGOPHER
  35.  
  36. There are a few files that you need to fetch from elsewhere:
  37. rextcpip.module         TCP/IP transport from Ken Hornstein; vers. 1.8.4
  38.                         (available from LISTSERV@DEARN.bitnet)
  39. rxsocket.module         TCP/IP transport from Arthur Ecock
  40.                         (available from LISTSERV@CUNYVM.bitnet)
  41. ywakeup.module          Wakeup system, available from
  42.                         LISTSERV@DEARN.bitnet
  43.  
  44. You might also find the following files on the same distribution
  45. media, respectively on the same ftp server:
  46. rextcpip.assemble       the modified version 1.8.4 of Ken Hornstein's
  47.                         REXTCPIP.MODULE (the TCP transport system)
  48.  
  49.  
  50. Note:   For TCP/IP version 1 you need to have REXTCPIP.MODULE; if you
  51.         have TCP/IP version 2 then you can choose between RXSOCKET
  52.         and REXTCPIP for the client.  The server needs REXTCPIP in any
  53.         case (a future version might also allow a choice).
  54. Note:   You can get RXSOCKET.MODULE or REXTCPIP.MODULE in a modified
  55.         version 1.8.4 directly from me.  The modifications are
  56.         documented in VIEGOPHR.PS.
  57. Note:   YWAKEUP.MODULE is possibly not needed.
  58.  
  59.  
  60. Source Listing:
  61. viegophr.tex            documentation in LaTeX format
  62. vieg-um.tex             user documentation in LaTeX format
  63. rosetex.awk             generate a LaTeX file from a product file
  64. vieg-pro.tex            LaTeX source listing of viegophr.product
  65. vieg-pro.ps             Postscript source listing of viegophr.product
  66. lpr.sty                 Line-Printer Style File used for running
  67.                         vieg-pro.tex down
  68. appleps.sty             page definitions in LaTeX, possibly not needed
  69.  
  70.  
  71. The complete main source in NED's HYX format together with the necessary
  72. tools can be obtained on request.  NED is a 'hypertexty' MSDOS editor.
  73. The file VIEGOPHR.HYX contains the documentation as well as the source
  74. code together with other items that are not included in the standard
  75. package.  NED can itself be used as an (experimental) Gopher client
  76. running under PC/TCP.  The files are:
  77. viegophr.hyx            HYX file
  78. viegophr.idx            Index file
  79. viegophr.lut            Lookup Table
  80. viegophr.bat            generate PRODUCT and TEX files from the HYX
  81.  
  82. If you want to use the HYX file you need the MSDOS text editor NED,
  83. put the hyx, idx and lut file in one directory and enter
  84.   ned -hy viegophr.hyx
  85.  
  86. =========================================================================
  87. QUICK'N'DIRTY INSTALLATION:
  88.  
  89. (For more information about the installation refer to the documentation
  90. found in VIEGOPHR.PS.)
  91.  
  92. Use this checklist to get the system off the ground:
  93.  
  94.  1 [ ]  Put VIEGOPHR.PRODCUT and ROSE.EXEC on any readable minidisk.
  95.  
  96.  2 [ ]  Prepare a R/W minidisk with filemode A with at least 2 cylinders
  97.         (275 blocks with 4096 byte).
  98.  
  99.  3 [ ]  If you have VIEGOPHR.FIX around somewhere, you can place it on
  100.         minidisk A, but this is not necessary.
  101.  
  102.  4 [ ]  Start the program generator by entering:
  103.         ROSE VIEGOPHR
  104.  
  105.  5 [ ]  Read the options presented by ROSE and answer the questions
  106.         appropriately.  In most cases you will want to use the
  107.         predefined option.  In this case simply enter code 1 or hit
  108.         the ENTER key.  If you want to change something enter code 3
  109.         (followed by pressing the ENTER key of course) and then enter
  110.         the value that you want to use.
  111.  
  112.  6 [ ]  After prompting for all options ROSE will generate all
  113.         modules and invoke the postinstallation procedure GOPHINST.EXEC.
  114.  
  115.  7 [ ]  Fetch any missing file that the postinstallion procedure might
  116.         point out.  If the postinstallation procedure finds
  117.         inconstencies in your installation, remove the appropriate
  118.         line from VIEGOPHR.FIX and go back to step 4.
  119.  
  120.  8 [ ]  Put the file VIEGOPHR.FIX at a safe place.  You might want
  121.         to use it again for a fast re-installation later on.
  122.  
  123.  9 [ ]  Place RXSOCKET.MODULE and/or REXTCPIP.MODULE on minidisk A.
  124.  
  125. 10 [ ]  Done!  Your minidisk A should now contain all necessary programs 
  126.         for the client and server.
  127.  
  128. 11 [ ]  If you don't want the server you can remove GOPHERDD.EXEC.
  129.  
  130. 12 [ ]  If you want to run the server it's time to look at the
  131.         documentation (VIEGOPHR.PS) now to find out about index files,
  132.         access groups, etc...
  133.  
  134.  
  135. =========================================================================
  136. If you have earlier version of VieGOPHER ...
  137.  
  138. ... you might want to know about a couple of changes.
  139.  
  140. GOPHERC.EXEC, Postinstaller
  141. The client code is not longer named GOPHER.EXEC, instead it's
  142. GOPHERC.EXEC.  The also new postinstaller generates a GOPHER.EXEC,
  143. if there doesn't exist one.  GOPHER.EXEC is intended to be customized
  144. by the administrator to access whatever disks are needed etc.
  145.  
  146. Files that are not longer needed and can be removed:
  147. GOPHRNG2.XEDIT          rolled into GOPHER.XEDIT
  148. GLOBALVV.EXEC           handled by standard GLOBALV
  149. GLOBALXV.EXEC           handled by standard GLOBALV
  150. FDNS.EXEC               only needed for REXTCPIP versions before 1.8.4
  151. FDNS.IN                 ditto
  152.  
  153.  
  154. =========================================================================
  155. COPYING and USING:
  156.  
  157. The files can be distributed and used freely in the spirit of the
  158. GNU Public License.  The point is, if you manage to sell this program
  159. to someone, I want my share.  If you give away the program for free and
  160. you're able to sell your expertise in installing and administrating the
  161. package, this is fine with me and I wish you the best.  
  162.  
  163. "No risk, no fun"...  Have fun, but use it at your own risk.
  164.  
  165.  
  166. =========================================================================
  167. TROUBLES?  SHOOT 'EM...
  168. (or what can go wrong will)
  169.  
  170. There are a couple of problems that you might run into:
  171.  
  172. *  The client starts but presents only an empty screen.
  173.    (REXTCPIP version)
  174.  
  175.    -> Check out if your TCPIP.DATA file contains an entry for a
  176.       nameserver at the loop-back address 14.0.0.0 or on your
  177.       local mainframe.  If so, put a modified TCPIP.DATA file on
  178.       a minidisk with a low enough filemode letter.  This file
  179.       should provide an entry for a nameserver on a Unix machine
  180.       instead of the loop-back address.
  181.  
  182.       On my own installation (awiwuw11.wu-wien.ac.at), the modified
  183.       TCPIP.DATA is placed on the same disk as all the other Gopher
  184.       modules.  Users are told either to access the Gopher disk as
  185.       a lower disk than TCPIP or not to use TCPIP at all.
  186.       (TCPIP is needed if the user wants to use Telnet-items from
  187.       Gopher menus, however.)
  188.  
  189.  
  190. *  The file VIEGOPHR.README doesn't contain any information about
  191.    a special problem and VIEGOPHR.PS doesn't help either.
  192.  
  193.    -> Try to describe your problem as complete as you can.  If you
  194.       have problems when you access a certain item on some fancy
  195.       server, please write down the Gopher coordinates (name, host,
  196.       port, type, path).
  197.       Send your problem description together with the FIX file
  198.       by email to <Gerhard.Gonter@wu-wien.ac.at>.
  199.